# ForiCode — ممیزی نهایی و مستقل کل پروژه، دیتابیس و تغییرات قبلی

## نقش و هدف

تو در این مرحله فقط **بازرس مستقل فنی پروژه** هستی، نه مجری اصلاحات.

من چند هفته است پروژه ForiCode را با کمک هوش مصنوعی توسعه داده‌ام. در این مدت قابلیت‌های مختلفی ساخته شده، اما چند بار گزارش «همه‌چیز درست شد» دریافت کرده‌ام و بعد مشخص شده مشکلاتی باقی مانده یا تغییرات جدید باعث ایرادهای دیگری شده‌اند.

به‌خصوص درباره تغییرات قبلی سیستم Settings و عملیات Dedupe دیتابیس نگرانی جدی دارم.

می‌خواهم برای یک بار، وضعیت واقعی پروژه را از ابتدا تا انتها بررسی کنی تا بتوانیم بعداً با تغییرات کوچک، قابل آزمایش و قابل بازگشت توسعه را ادامه دهیم.

**هدف این پاس: کشف حقیقت، نه اصلاح پروژه.**

---

# ۱. قوانین غیرقابل مذاکره

- هیچ فایل اصلی را ایجاد، ویرایش یا حذف نکن.
- هیچ تغییر روی دیتابیس فعلی ایجاد نکن.
- هیچ Migration، Seeder، Installer، Update Script یا Fix Script عملیاتی اجرا نکن.
- هیچ خرید، شارژ، برداشت، بازپرداخت یا پرداخت واقعی انجام نده.
- هیچ درخواست عملیاتی به FiveSim، درگاه بانکی، سرویس پیامک یا ایمیل ارسال نکن.
- هیچ روت ورود موقت، Backdoor یا Authentication Bypass ایجاد نکن.
- هیچ Secret، رمز عبور، APP_KEY، API Key یا Token را در گزارش چاپ نکن.
- هیچ تغییر روی هاست انجام نده.
- فایل‌ها و تغییرات موجود کاربر را حفظ کن.
- اگر تستی نیاز به تغییر داده دارد، فقط روی کپی کاملاً ایزوله و با داده ساختگی اجرا شود.
- اگر امکان ایزوله‌سازی ایمن وجود ندارد، تست را اجرا نکن و آن را تأییدنشده گزارش کن.
- هیچ ادعای گزارش قبلی را بدون بررسی مستقل قطعی فرض نکن.

قبل از شروع، `AGENTS.md` و دستورالعمل‌های موجود پروژه را بخوان.

## وضعیت Read-only

در آغاز و پایان:

- Git HEAD
- Branch
- Working Tree
- فایل‌های تغییرکرده و Untracked
- وضعیت دسترسی دیتابیس

را ثبت کن.

اگر اجرای تستی باعث Cache، Log یا فایل موقت می‌شود، اثر آن را از قبل مشخص کن و آن را پنهان نکن.

---

# ۲. شناسایی پروژه و محیط واقعی

پروژه مورد انتظار:

`C:\laragon\www\foricode-now`

دامنه:

`foricode.ir`

محیط:

Windows + Laragon

آدرس محلی:

`http://foricode-now.test`

دیتابیس مورد انتظار:

`foricode_now`

بررسی کن:

- مسیر واقعی پروژه
- نسخه Laravel و PHP
- Composer و وابستگی‌ها
- Git HEAD، تاریخچه Commitها و Tagها
- ساختار ماژول‌ها
- تنظیمات محیط بدون نمایش Secret
- اتصال واقعی MySQL
- وضعیت Web Server
- روش Deploy
- فایل‌های SQL، Migration و Seeder
- تست‌ها و مستندات

اگر MySQL خاموش است، ابتدا وضعیت Laragon را گزارش کن. بدون اجازه من دیتابیس اصلی را دستکاری نکن.

---

# ۳. اولویت بحرانی — بررسی تغییرات قبلی Settings و دیتابیس

این بخش برای من از مهم‌ترین قسمت‌های ممیزی است.

در توسعه قبلی، یک AI برنامه‌نویس سیستم Settings را تغییر داد و عملیات Dedupe انجام داد.

در اولین اصلاح، `Setting::set()` می‌توانست Setting هم‌نام در Group دیگری را حذف کند.

بعداً گزارش شد این رفتار اصلاح شده و استقلال `(group,key)` حفظ می‌شود.

همچنین حدود ۱۸ Key تکراری پاکسازی شدند و یک اختلاف در `chat_ai_system_prompt` گزارش شده بود.

**نمی‌خواهم به گزارش همان AI اعتماد کنی. مستقلاً بررسی کن.**

### ۳.۱ — پیدا کردن Backup درست

بکاپ‌های موجود را بررسی کن، از جمله:

`C:\laragon\www\_vn_backups\20261007-053028`

`C:\laragon\www\_vn_backups\20261007-121346`

و بکاپ‌های قدیمی‌تر.

با Git History مشخص کن:

- اولین تغییر واقعی سیستم Settings چه زمانی انجام شده؟
- عملیات Dedupe در کدام مرحله انجام شده؟
- کدام Backup واقعاً قبل از اولین Dedupe است؟
- کدام Backup بعد از آن است؟

صرف نام پوشه یا توضیح گزارش قدیمی برای تشخیص زمان کافی نیست.

### ۳.۲ — مقایسه دیتابیس قبل و بعد

بدون Restore کردن روی دیتابیس اصلی، مقایسه کن:

- کل جدول Settings
- تعداد رکوردها
- تمام Keyهای هم‌نام در Groupهای مختلف
- Rowهای حذف‌شده
- Rowهای اضافه‌شده
- Rowهای تغییرکرده
- ID و Group هر ردیف
- مقدار مؤثر قبل و بعد
- `updated_at`
- Schema و Indexها
- Settingهای مالی و حساس

برای Secretها فقط نتیجه مقایسه امن، طول یا Hash مناسب گزارش شود؛ هیچ مقدار محرمانه‌ای منتشر نشود.

### ۳.۳ — احتمال حذف Setting مستقل

وجود دو Setting با Key یکسان در Group متفاوت الزاماً اشتباه نیست.

مثلاً:

`header.title`

و:

`footer.title`

می‌توانند کاملاً مستقل باشند.

برای هر Row حذف‌شده بررسی کن:

- آیا واقعاً Shadow و اضافی بوده؟
- آیا دو مقدار معنای متفاوت داشته‌اند؟
- آیا Consumer جداگانه داشته‌اند؟
- آیا حذف آن روی رفتار واقعی سایت اثر گذاشته؟
- آیا مقدار مؤثر اصلی حفظ شده؟

صرف برابر بودن Valueها برای اثبات بی‌استفاده‌بودن یک ردیف کافی نیست.

### ۳.۴ — مقایسه کدهای قدیمی و جدید

از Git History این موارد را بررسی کن:

- `Setting::get`
- `Setting::set`
- `getExact`
- `groupMap`
- `canonicalGroup`
- `canonicalMap`
- Cache handling
- SettingController
- SettingSeeder
- Migrationهای Settings
- Direct read/writeها
- تمام Consumerهای مهم

مشخص کن قبل و بعد از تغییر هر Setting چگونه خوانده و نوشته می‌شد.

### ۳.۵ — تست استقلال Groupها

در محیط ایزوله، تست کن:

- Key یکسان در دو Group
- خواندن جداگانه
- ذخیره یک Group بدون تغییر دیگری
- عدم حذف یا Merge
- حفظ مقدار صفر و False
- رفتار Defaultها
- Cache invalidation
- Namespaceهای `referrals` و `virtual_numbers`

### ۳.۶ — اختلاف Prompt چت

در گزارش قدیمی:

`chat_ai_system_prompt`

ابتدا ۱۹۷۶۳ بایت و بعداً ۳۰۶۱۰ بایت گزارش شده بود.

مشخص کن این اختلاف در کدام بازه و کدام نسخه رخ داده.

اگر نمی‌توانی هویت تغییر‌دهنده را اثبات کنی، آن را به کاربر یا AI نسبت قطعی نده.

محتوای Prompt را چاپ یا تغییر نده.

### ۳.۷ — نتیجه مستقل Settings

در پایان دقیقاً پاسخ بده:

**آیا عملیات Dedupe قبلی هیچ Setting مستقل یا مقدار مهمی را از بین نبرده است؟**

یکی از این نتایج را اعلام کن:

- تأییدشده و سالم
- مشکل اثبات‌شده
- هنوز قابل تأیید نیست

اگر قطعی نیست، دقیقاً بگو کدام مدرک کم است.

---

# ۴. Migration، Schema و Deploy

این مورد را هم با اولویت بالا بررسی کن.

ما قبلاً روی Migration و روش انتقال تغییرات کار کرده‌ایم، ولی گزارش‌ها درباره وضعیت نهایی آن یکسان نیستند.

بررسی کن:

- جدول واقعی `migrations`
- فایل‌های Migration
- Schema و Indexهای واقعی
- Migration ثبت‌نشده با جدول موجود
- Migration ثبت‌شده با ساختار ناقص
- وضعیت SQL نصب تازه
- UpdateController
- روش Rollback
- بکاپ دیتابیس
- سازگاری کد و دیتابیس
- فایل‌های Installer و Upgrade
- رفتار Migration پس از خطا

هیچ Migration روی دیتابیس اصلی اجرا نکن.

### نکته ویژه

روش موردنظر من برای استقرار، همان روش فعلی PHP Installer/Fix Package است.

بدون بررسی، پیشنهاد تغییر آن به Git Checkout مستقیم روی هاست نده.

مشخص کن آیا این روش فعلی امن، قابل تکرار و قابل بازیابی هست یا نه.

---

# ۵. امنیت کل پروژه

تمام قسمت‌های حساس را بررسی کن:

- `.env` و Git History
- فایل‌های ZIP و Backup
- Document Root
- `.htaccess`
- `install.php`
- `cron-schedule.php`
- UpdateController
- TLS و اصالت بسته‌های دانلودی
- Authentication
- Authorization
- Sessions
- CSRF
- Password Reset
- Email/Mobile Verification
- Admin Permissions
- API Authentication
- Rate Limiting
- IDOR
- File Upload
- File Download
- Private Files
- Secret Exposure

یافته‌های قبلی مانند دسترسی به سبد مهمان دیگر، حفظ وضعیت تأیید ایمیل/موبایل پس از تغییر و فایل‌های پیوست عمومی را دوباره بررسی کن.

---

# ۶. عملیات مالی و کیف پول

تمام مسیرهای مالی را بررسی کن:

- شارژ کیف پول
- پرداخت آنلاین
- کارت‌به‌کارت
- اعتبار هدیه
- مالیات
- پرداخت ترکیبی
- Callback درگاه
- Order Completion
- Cancel
- Refund
- Withdraw
- تراکنش‌ها و Ledger
- رزرو و تحویل محصول

سناریوهای ضروری:

- یک واریز بانکی برای دو شارژ
- Callback تکراری
- Callback لغو برای پرداخت موفق
- خطای میانی بعد از دریافت پول
- سفارش پرداخت‌شده اما ناقص
- Refund تکراری
- برداشت هم‌زمان
- موجودی منفی
- دو خرید هم‌زمان از آخرین موجودی
- خطای شبکه و Timeout
- قطع Session هنگام پرداخت
- اختلاف موجودی کیف پول با تاریخچه تراکنش‌ها

یافته‌های قبلی `FIN-01` تا `FIN-10` و `INV-01` تا `INV-03` را در سورس فعلی تطبیق بده.

تست مالی فقط با داده ساختگی و محیط کاملاً ایزوله مجاز است.

---

# ۷. سیستم Settings — سایر ایرادات

علاوه بر Dedupe، بررسی کن:

- Secret masking
- Password blank-save
- Cache invalidation
- Cache کردن Default برای Setting ناموجود
- JSON validation
- Type preservation
- `0`، `false`، `null` و empty
- Direct DB writes
- Seeder idempotency
- Permissionهای Admin Settings

موارد قبلی مثل:

`card_auto_confirm_tolerance ?: 50000`

و `card_auto_confirm_window` را از نظر رفتار واقعی و اعتبارسنجی بررسی کن.

هیچ اصلاح عمومی یا تغییر معماری پیشنهاد نده مگر علت و اثر دقیق آن اثبات شده باشد.

---

# ۸. محصولات، سفارش‌ها و موجودی

بررسی کن:

- انواع Product
- فعال/غیرفعال
- Duplicate تکی و گروهی
- Bulk Actions
- Archive و Restore
- حذف دائم
- نمایش Badgeها
- Cart
- Checkout
- Order
- Inventory Reservation
- Account Inventory
- Code Inventory
- Subscription
- Delivery
- Refund
- مدیریت سفارش از پنل Admin

هر مسیر خرید باید از نظر هم‌زمانی و تحویل تکراری بررسی شود.

---

# ۹. ماژول شماره مجازی

طرح موردنظر:

- فارسی و RTL
- Grid فشرده
- جستجوی فارسی/انگلیسی
- سرویس‌های محبوب
- Drawer انتخاب کشور
- بدون انتخاب مستقیم اپراتور
- قیمت و موجودی
- پرچم و آیکون محلی
- خرید مستقیم
- صفحه اختصاصی سفارش
- Polling پیامک
- نمایش LTR شماره و کد
- My Numbers
- Cancel / Ban
- مدیریت از پنل Admin

تمام Routeها، Controllerها، Serviceها، Providerها و Viewهای مربوط را Trace کن.

**خرید صفحه `/numbers` فعلاً عمداً Mock است.**

Mock بودن را باگ غیرمنتظره گزارش نکن.

اما بررسی کن مسیرهای QuickBuy، Cron، refresh/check یا هر مسیر دیگر نتوانند ناخواسته عملیات واقعی FiveSim یا برداشت کیف پول را در حالت تست اجرا کنند.

قابلیت‌های Auto-expire، Cancel Cooldown، Quick Access و FiveSim واقعی برای آینده هستند.

---

# ۱۰. سایر امکانات سایت

همه ماژول‌ها را بررسی کن:

- پنل کاربری
- پنل مدیریت
- تیکتینگ
- چت آنلاین
- چت با هوش مصنوعی
- وبلاگ
- CMS
- تخفیف‌ها
- کمپین‌ها
- Referral
- Loyalty
- Notifications
- Email/SMS
- Reports
- Supplier Management
- SEO
- Site Settings

برای هر ماژول وضعیت واقعی را مشخص کن:

- آماده و تست‌شده
- پیاده‌سازی‌شده ولی تست‌نشده
- ناقص
- دارای مشکل اثبات‌شده
- آزمایشی
- برنامه‌ریزی‌شده برای آینده

---

# ۱۱. UI/UX در مرورگر واقعی

اگر مرورگر قابل استفاده داری، سایت محلی را بررسی کن.

با Session معتبر و بدون دورزدن Login.

اگر Admin Login لازم است، از من بخواه خودم وارد شوم.

بخش‌های اصلی:

- Home
- Products
- Numbers
- Order Page
- My Numbers
- Admin Products
- VN Services
- VN Countries
- VN Orders
- Settings
- Header/Footer
- Wallet
- Cart/Checkout

در موبایل و دسکتاپ بررسی کن:

- RTL/LTR
- Responsive
- Icon/Flag
- Drawer/Modal
- CTA
- Form
- Navigation
- Console
- Network
- Broken Image
- Error States

صرف HTML، Blade یا HTTP 200 برای تأیید UI کافی نیست.

اگر مرورگر یا وب‌سرور در دسترس نیست، Browser UI را Not Verified اعلام کن.

---

# ۱۲. Performance، Build و تست‌ها

بررسی کن:

- N+1
- Query Count
- Pagination
- Indexها
- Cache
- Scheduler
- Cron
- Queue
- Memory
- Log Growth
- Large Files
- Duplicate Routes
- Composer Dependencies
- NPM/Vite Build
- قابلیت بازسازی از Checkout تمیز
- PHPUnit
- Feature/Integration Tests
- Test Isolation
- پوشش عملیات مالی و امنیتی

صرف بزرگ‌بودن فایل یا تعداد Query را باگ بحرانی ندان.

---

# ۱۳. تطبیق یافته‌های ممیزی قبلی

ممیزی قبلی شناسه‌هایی مانند این داشت:

- DEP-01 تا DEP-05
- SEC-01 تا SEC-08
- FIN-01 تا FIN-10
- INV-01 تا INV-03
- SET-01 تا SET-03
- VN-01 تا VN-03
- OPS-01
- PERF-01 تا PERF-03
- BLD-01
- TST-01

تمام این شناسه‌ها را در نسخه فعلی بررسی کن.

برای هر کدام مشخص کن:

- هنوز وجود دارد؟
- رفع شده؟
- بازتولید می‌شود؟
- فقط بالقوه است؟
- برای Phase بعدی است؟
- به تست MySQL/Browser نیاز دارد؟

شناسه‌ها را حفظ کن تا بتوانیم نتیجه را با گزارش قبلی مقایسه کنیم.

---

# ۱۴. قالب گزارش نهایی

## A — نتیجه کلی

به زبان ساده بگو ForiCode در چه وضعیتی است و برای فروش واقعی چه موانعی دارد.

## B — وضعیت بحرانی دیتابیس و Settings

قبل و بعد Dedupe، Rowهای حذف‌شده، استقلال Groupها و حفظ مقادیر مهم را جداگانه گزارش کن.

## C — وضعیت Migration و Deploy

مشخص کن حل شده، نیمه‌حل‌شده یا تأییدنشده است.

## D — جدول وضعیت تمام ماژول‌ها

برای هر ماژول وضعیت، میزان اثبات، مشکل و نیاز بعدی را بنویس.

## E — جدول تمام Findings

ستون‌ها:

- ID
- Severity
- Status
- File:Line
- Evidence
- Impact
- Suggested Fix
- Required Verification

## F — موارد رفع‌شده

فقط مواردی که با کد و تست اثبات شده‌اند.

## G — موارد تأییدنشده

به‌خصوص DB، مرورگر، هم‌زمانی واقعی MySQL و هاست.

## H — نقشه راه اجرایی

اولویت‌بندی:

- P0: امنیت و استقرار
- P1: پرداخت، کیف پول و موجودی
- P2: UI و کیفیت محصول
- P3: امکانات آینده

برای هر مورد، وابستگی‌ها و تست پذیرش را بنویس.

## I — اولین قدم کوچک

در پایان فقط **یک کار کوچک و مشخص** پیشنهاد بده که بتوانیم بدون تغییر گسترده پروژه انجام دهیم.

## J — سلامت ممیزی

- Git HEAD قبل/بعد
- Dirty Status قبل/بعد
- تغییرات فایل و دیتابیس
- تست‌های اجراشده
- موارد بدون امکان تست
- محدودیت‌های ابزار

---

# ۱۵. قانون نهایی

نمی‌خواهم صرفاً یک گزارش طولانی یا امیدوارکننده بگیرم.

می‌خواهم یک گزارش دقیق، قابل استناد و قابل استفاده برای تصمیم‌گیری داشته باشم.

برای هر یافته یکی از این وضعیت‌ها را انتخاب کن:

- Confirmed
- Fixed
- Potential
- Needs Runtime Verification
- Intentional / Deferred
- Not Applicable

نبود تست، به‌تنهایی اثبات وجود باگ نیست.

پاس‌شدن تست بازتولید آسیب‌پذیری، به معنی سالم‌بودن سیستم نیست.

**مهم‌ترین بخش برای من: اثبات اینکه تغییرات قبلی Settings و دیتابیس باعث حذف یا خراب‌شدن اطلاعات مستقل و مهم نشده‌اند.**

اگر به Backup یا دیتابیس دسترسی نداری، این موضوع را مخفی نکن و نتیجه قطعی نده.

هیچ Fix، Refactor، Migration، Deploy یا عملیات مالی انجام نده.

گزارش نهایی را به فارسی ارائه بده و متوقف شو.

بعد از بررسی، قرار است مشکلات را یک‌به‌یک و با تست قبل/بعد حل کنیم؛ نه اینکه دوباره ده‌ها فایل را هم‌زمان تغییر دهیم.